home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 151-175 / scopedisk159 / spreadsheet / spread.doc < prev    next >
Text File  |  1995-03-19  |  15KB  |  345 lines
  1.  
  2.  
  3. *****************************************************************************
  4.  
  6.  
  7.     SPREAD - Tiny Amiga spreadsheet
  9.     Spread history (as if you care):
  10.  
  11.     This program grew from a notion I had, 4 years ago, that a
  12. spreadsheet would be a good tool to have, to help with certain jobs at
  13. the office. I had read about VisiCalc, and later Lotus 1-2-3, but I had
  14. never used a spreadsheet, so I designed Spread with few pre-conceived
  15. notions about how it should work. As far as I know, Spread bears little
  16. resemblance to any other spreadsheet.
  17.  
  18.     The first version of Spread was written to run on a PDP-11
  19. running RT11 or TSX, with a VT220 terminal. It was written in Decus C,
  20. it only supported fixed-12-character columns, and only what the screen
  21. could display. It was later enhanced to support a larger worksheet with
  22. scrolling, and to support a 132 column display. Spread is still used at
  23. the office almost use daily.
  24.  
  25.     When I found myself dialing in to work from my Amiga to use
  26. Spread fairly often (a long distance phone call too), I decided it was
  27. time to port the program over to the Amiga.
  28.  
  29.     The PDP-11 Spread used VT220 display controls and accepted VT220
  30. function keys. These are not completely compatible with the features of
  31. the Amiga CON: device, so I decided to re-write the user interface to
  32. make best use of the Intuition's input and output features.
  33.  
  34.     I started work on the Amiga version in early January 1988, and
  35. spent most evenings and weekends at the keyboard (my wife hated it). You
  36. have the result before you.
  37.  
  38.     Amiga Spread supports a few features the PDP11 version doesn't,
  39. specifically the ability of a text cell to overlay empty cells to the
  40. right, the ability to set the column width and decimals, it supports a
  41. larger worksheet (The PDP version must run in only 56K!), and of course
  42. the Intuition interface.
  43.  
  44.     Spread features:
  45.  
  46.     o Small 36 X 60 worksheet
  47.     o Four basic math functions, plus row and column summing
  48.     o Intuition-ized user interface
  49.     o Resizable Workbench window
  50.     o Absolute and symbolic cell references in formulas
  51.     o Worksheet editing: insert/delete row, insert/delete column
  52.     o Cell editing: cut, copy, paste, erase single cells
  53.     o Variable column width and decimal places
  54.     o Automatic or Manual recalculation
  55.  
  56.     Running Spread:
  57.  
  58.     Spread can be invoked from the CLI or launched from a Workbench
  59. icon. If launched from the Workbench, the Lattice C startup code will
  60. first open a standard input/output window, which Spread ignores. It is
  61. recommended that Spread be given a stack size of 8000. A larger stack
  62. size provides no benefit.
  63.  
  64.     If Spread is run from the CLI, you can include a command
  65. parameter specifying the name of a file which Spread will load as the
  66. current spreadsheet.
  67.  
  68.     The Spread window gives a display of (r) rows and (n) columns.
  69. The number of rows and columns depends on the current size of the
  70. display window, the width of the individual columns, and the narrow/wide
  71. font selection. The intersection of each line and column is called a
  72. cell. Cells may be empty, or they may contain text, or they may contain
  73. a formula.
  74.  
  75.     Spread currently supports 60 rows and 36 columns. This is very
  76. small by commercial product standards.
  77.  
  78.     In the window, one cell is displayed in reverse; this indicates
  79. the 'cursor'. The cursor may be moved using the arrow keys, or by
  80. pointing to a cell with the mouse pointer and clicking.
  81.  
  82.     If a movement would place the cursor on a cell which is not in
  83. the display window, the display is scrolled. The horizontal and vertical
  84. scroll bars also move the display window and the cursor.
  85.  
  86.     If a cell contains text, then the text is displayed in the
  87. window in that cell. If the text is wider than the current column's
  88. width, then the text will 'overflow' into empty cells to the right of
  89. the selected cell. If the text is so long that it would overflow into a
  90. cell that is occupied, then the text is truncated at that point.
  91.  
  92.     If a cell contains a formula, then the result of the formula is
  93. displayed in the cell in the window. Calculations are double precision
  94. floating point. The number display is initially 2 decimal places.
  95.  
  96.     The contents of a formula cell is a string in simple algebraic
  97. notation. It is evaluated according to the following rules:
  98. Multiplication ('*'), division ('/'), and modulo ('%') are performed
  99. first, from left to right; then addition ('+') and subtraction ('-')
  100. from left to right; then MAX and MIN left to right; then conditionals
  101. from left to right. The order of evauation can be forced by the use of
  102. parentheses.
  103.  
  104.     If you want a cell to simply contain a number, then make it a
  105. formula cell, and type in the number you want as the formula.
  106.  
  107.     Formula cells may be given logical names. The names can be
  108. referred to in other cells' formulas to call the value from the cell;
  109. this allows cell position changes within the display without affecting
  110. the logical sources for values in formulas. Only formula cells may be
  111. given names. The name must begin with a letter, and may contain
  112. letters and numbers. It may not contain spaces.
  113.  
  114.     Cell editing (text, formula, or name) is done in the string
  115. gadgets at the bottom of the window.
  116.  
  117.     When the cursor is on an empty cell, the entry gadgets at the
  118. bottom of the window are ghosted and cannot be selected. The "Cells"
  119. menu allows the choice of either a text cell or a formula cell. If
  120. "Cells/Edit Text cell" or "Cells/Edit Formula Cell" is chosen, then the
  121. cell type is chosen, the text gadget is enabled and activated, and the
  122. text may be entered immediately.
  123.  
  124.     When the cursor is on a text cell, the cell's text is placed in
  125. the text gadget. This gadget can be selected and the text modified.
  126.  
  127.     When the cursor is on a formula cell, the cell's formula and
  128. name are placed in the text and name gadgets. These can be selected and
  129. modified.
  130.  
  131.     If you wish to change a text cell to a forumla cell or vice
  132. versa, you must erase the current cell and define it anew. The menu
  133. entries "Edit/Cut" or "Edit/Erase" will erase the contents of a cell.
  134.  
  135.     Calculation can be set to automatic or manual. In automatic
  136. mode, whenever a formula cell is edited or any change which may effect
  137. the numeric results of other cells is performed, recalculation takes
  138. place. In manual mode, recalculation is done when the "Calculate/
  139. Evaluate" menu entry is selected, when the user presses the 'C' key, and
  140. upon loading a new spreadsheet from disk, and no other time.
  141.  
  142.     Calculation is done as follows: Each formula in the spreadsheet
  143. is solved, starting in cell R0C0 and moving down, then repeating for
  144. successive columns moving right. Cells which depend on other cells'
  145. values should be placed under or to the right of the cells which supply
  146. the values.
  147.  
  148.     If a cell must make a 'forward' reference, to a cell which will
  149. be calculated later in the spreadsheet, then calculating twice will
  150. usually result in the correct value.
  151.  
  152.     If a calculation can't be performed, the cell will display asterisks
  153. ('****.**') instead of a number. You should inspect your formula to see
  154. what is wrong. You may have left your parentheses unbalanced, or perhaps
  155. you refer to a cell name that you haven't defined. 
  156.  
  157.     Formulas
  158.  
  159.     Formulas are algebraic expressions similar to FORTRAN or BASIC
  160. expressions. Operations proceed left to right, according heirarchy
  161. (multiplication after addition, etc). Expressions may be grouped with
  162. parentheses.
  163.  
  164.     Values are included in an expression using the following
  165. notations:
  166.  
  167.     <value>    - a number, like '10', '-5', '2.34'
  168.     RmCn    - takes the value in the cell at row (m) column (n)
  169.           Special case, either (m) or (n) can be '.', which
  170.           means to use the current row/column
  171.     name    - takes the value in the cell with the given name.
  172.  
  173.     The following arithmetic operators are provided:
  174.  
  175.     +    Addition                p + q
  176.     -    Subtraction                p - q
  177.     *    Multiplication                p * q
  178.     /    Division                p / q
  179.     %    Modulo (remainder from division)    p % q
  180.     MAX    greater of two values            p MAX q
  181.     MIN    lesser of two values            p MIN q
  182.  
  183.     -    Negate                    -p
  184.     ABS    Absolute value                ABS(p), ABS p
  185.     INT    Extract integer portion            INT(p), INT p
  186.  
  187.     SUM    Sum of all cells in a row or column above/to the left of
  188.         the current cell. SUM's format:
  189.  
  190.         SUM(RmCn)
  191.  
  192.         'm' and 'n' can be:
  193.             a row/column number
  194.             '.' to specify the current row/column
  195.             '*' to specify all the rows/columns above/to
  196.                 the left
  197.         Any of the above formats for 'row' and 'col' can be
  198.         combined except R*C*, which is invalid.
  199.  
  200.     Conditional Binary operators; these are entered as binary
  201. operators (one operand on each side) and give the second operand if the
  202. conditional test on the first operand is true, otherwise they give zero:
  203.  
  204.     ?EQ    op = 0            7 ?EQ 3 = 0    0 ?EQ 3 = 3
  205.     ?NE    op not = 0        7 ?NE 3 = 3    0 ?NE 3 = 0    
  206.     ?GT    op greater than 0    7 ?GT 3 = 3    -7 ?GT 3 = 0
  207.     ?GE    op greater or equal 0    7 ?GE 3 = 3    -7 ?GE 3 = 0
  208.     ?LT    op less than 0        7 ?LT 3 = 0    -7 ?LT 3 = 3
  209.     ?LE    op less or equal 0    7 ?LE 3 = 0    -7 ?LE 3 = 3
  210.  
  211.  
  212.     Spread menu selections:
  213.  
  214.     "Project" Menu
  215.  
  216.     "Project/New": Erases the entire contents of the current
  217. spreadsheet.
  218.  
  219.     "Project/Load": Erases the entire contents of the current
  220. spreadsheet, then loads a previously-saved spreadsheet. This brings up a
  221. requester asking for the name of the file to load.
  222.  
  223.     "Project/Save": Saves the current spreadsheet into a file.
  224. Project/Save uses the same file name as the spreadsheet that was loaded,
  225. or if no file name has been specified, it puts up a requester asking for
  226. the name of the file to save to.
  227.  
  228.     "Project/Save as..": saves the current spreadsheet into a file.
  229. This puts up a requester asking for the name of the file to save to.
  230.  
  231.     "Project/Print": prints to a file a displayable image of the
  232. current spreadsheet. This puts up a requester asking for the name of the
  233. file to print to, which can be "PRT:" to print directly to the printer.
  234. (Note: background printing is not implemented, meaning that Spread will
  235. stall until the spreadsheet had been printed entirely.)
  236.  
  237.     "Project/About Spread": Try it and see.
  238.  
  239.     "Project/Quit": Leaves Spread. If a spreadsheet is loaded it
  240. will be lost; make sure you save it first if you want to keep it. The
  241. close window button in the upper left corner performs the same function.
  242.  
  243.     "Edit" Menu
  244.  
  245.     "Edit/Cut": The current cell is saved in the paste buffer, and
  246. becomes empty. (The 'current' cell is the cell the cursor is positioned
  247. on, which is displayed in reverse.)
  248.  
  249.     "Edit/Copy": The current cell is saved in the paste buffer. The
  250. current cell is not altered.
  251.  
  252.     "Edit/Paste": If the current cell is empty, then the contents of
  253. the paste buffer is placed in the current cell.
  254.  
  255.     "Edit/Erase": The current cell is made empty. It is not saved in
  256. the paste buffer, and the paste buffer is not disturbed.
  257.  
  258.     "Edit/Insert Row": The contents of all cells below and to the
  259. right of the current cell, including the current cell, are shifted one
  260. row down. The current cell and all the cells in the current row to the
  261. right are made empty.
  262.  
  263.     "Edit/Insert Col": The contents of all cells below and to the
  264. right of the current cell, including the current cell, are shifted one
  265. row to the left. The current cell and all cells below the current cell
  266. are made empty.
  267.  
  268.     "Edit/Delete Row": The contents of all cells below and to the
  269. right of the current cell are shifted one row up. The contents of the
  270. current cell, and of all cells in the current row to the right, are
  271. lost.
  272.  
  273.     "Edit/Delete Col": The contents of all cells below and to the
  274. right of the current cell are shifted one row to the left. The contents
  275. of the current cell, and of all cells in the current column below, are
  276. lost.
  277.  
  278.     Warning: If any cells use RmCn notation with actual cell numbers
  279. in a formula, and the target cell is moved by any insert or delete
  280. operation, then it's likely the formula is now incorrect. The cell name
  281. feature should be used when making references to cells in formulas, as
  282. name references are resolved regardless of cell locations.
  283.  
  284.     "Cells" Menu
  285.  
  286.     "Cells/Edit Cell Text": If the current cell is empty, it is made
  287. a text cell. The Text gadget at the bottom of the window is activated,
  288. as if you had clicked on it. Pressing the 'E' key has the same effect as
  289. "Cells/Edit Cell Text", or if the text gadget is not ghosted you may
  290. simply click on it to edit.
  291.  
  292.     "Cells/Edit Cell Formula": If the current cell is empty, it is
  293. made a formula cell. The Text gadget at the bottom of the window is
  294. activated, as if you had clicked on it. Pressing the 'F' key has the
  295. same effect as "Cells/Edit Cell Formula", or if the text gadget is not
  296. ghosted you may simply click on it to edit.
  297.  
  298.     "Cells/Edit Cell Name": The Name gadget at the bottom of the
  299. window is activated, as if you had clicked on it. Pressing the 'N' key
  300. has the same effect as "Cells/Edit Cell Name", or if the name gadget is
  301. not ghosted you may simply click on it to edit.
  302.  
  303.     "Calculate" Menu
  304.  
  305.     "Calculate/Evaluate": The formulas in the current spreadsheet
  306. are solved, and the results of the calculations are displayed in the
  307. formula cells. This is the way to cause calculation if Auto Calc is
  308. disabled, or if a calculation makes a forward referece to a cell (see
  309. 'order of calculation' above).
  310.  
  311.     "Calculate/Auto Calc": When this entry is checked, the 'auto
  312. calc' feature is enabled. Selecting this entry toggles it's state
  313. between enabled (checked) and disabled (not checked).
  314.  
  315.     "Format" Menu
  316.  
  317.     "Format/Set Column Width": This entry brings up a requester
  318. which allows you to enter the width of the current column, by the number
  319. of characters it should hold.
  320.  
  321.     "Format/Set Decimal Places": This entry brings up a requester
  322. which allows you to enter the number of digits to the right of the
  323. decimal point should be printed for formula cells in the current column.
  324.  
  325.     "Format/Set Normal Font": Selecting this entry causes Spread to
  326. use Topaz/8 for cell display.
  327.  
  328.     "Format/Set Narrow Font": Selecting this entry causes Spread to
  329. use the teeny/8 font for cell display. The teeny/8 font distributed with
  330. Spread uses 5 pixel wide character spacing, which can display up to 128
  331. characters on the 640-pixel Workbench screen, although the border
  332. imagery around the Spread window allows only about 120 characters. If
  333. the 'teeny/8' font is not in your current fonts: directory, this menu
  334. selection will be ghosted.
  335.  
  336.     If you generate your own font and call it teeny/8, or copy
  337. another existing font to teeny/8, then Spread will use it with it's
  338. metrics. It should be an 8 pixel high font, but could be a wider or
  339. narrower font, fixed spacing or proportional. Spread will adjust
  340. accordingly.
  341.  
  342.  
  343. ************************************************************************
  344.  
  345.